Release 10.1A: OpenEdge Development:
Progress 4GL Reference

EXPORT-PRINCIPAL( ) method

Exports a sealed Client-principal object, with its currently defined property and attribute settings, by converting it to a raw value. You can assign this value to a RAW variable and send it to another client (such as the AppServer™). The receiving client can then import the raw value into another Client-principal object handle, using the IMPORT-PRINCIPAL( ) method, and use the imported object to set a user ID using either the SET-CLIENT( ) method or SET-DB-CLIENT function.

Return type: RAW

Applies to: Client-principal object handle

Syntax

EXPORT-PRINCIPAL( )

If the Client-principal object is in the initial (presealed) LOGOUT state, Progress generates a run-time error.

Calling this method does not generate an audit event or an audit record.

Example

The following code fragment illustrates how to use the EXPORT-PRINCIPAL( ) method:

DEF VAR hCP as HANDLE. DEF VAR raw-cp as RAW. . . . CREATE CLIENT-PRINCIPAL hCp. . . . raw-cp = hCP:EXPORT-PRINCIPAL( ).

See also

IMPORT-PRINCIPAL( ) method, SET-CLIENT( ) method, SET-DB-CLIENT function